package com.example.redislearning.service;

import com.example.redislearning.entity.User;
import java.util.List;
import java.util.Map;

/**
 * 用户管理服务接口
 * 包含用户注册、登录、信息查询、积分管理等功能
 */
public interface UserService {

    /**
     * 用户注册
     */
    User registerUser(User user);

    /**
     * 用户登录
     */
    User login(String username, String password);

    /**
     * 根据ID查询用户信息（带Redis缓存）
     */
    User getUserById(Integer userId);

    /**
     * 更新用户信息
     */
    User updateUser(User user);

    /**
     * 删除用户
     */
    boolean deleteUser(Integer userId);

    /**
     * 获取用户积分（Redis计数器）
     */
    Integer getUserPoints(Integer userId);

    /**
     * 增加用户积分
     */
    Integer incrementUserPoints(Integer userId, Integer points);

    /**
     * 减少用户积分
     */
    Integer decrementUserPoints(Integer userId, Integer points);

    /**
     * 获取用户学习时长统计（Redis计数器）
     */
    Integer getUserStudyDuration(Integer userId);

    /**
     * 增加用户学习时长
     */
    Integer incrementStudyDuration(Integer userId, Integer durationMinutes);

    /**
     * 获取用户排行榜（Redis ZSet）
     * @param type 排行榜类型：points, study_duration, courses_completed
     * @param limit 返回前N名
     */
    List<Map<String, Object>> getUserLeaderboard(String type, int limit);

    /**
     * 获取用户统计信息
     */
    Map<String, Object> getUserStatistics(Integer userId);

    /**
     * 检查用户名是否存在
     */
    boolean isUsernameExists(String username);

    /**
     * 检查邮箱是否已注册
     */
    boolean isEmailExists(String email);
}